Document ownership of filters. (#169101, Sebastian Rittau)

2005-03-07  Matthias Clasen  <mclasen@redhat.com>

	* gtk/gtkfilechooser.c (gtk_file_chooser_add_filter): Document
	ownership of filters.  (#169101, Sebastian Rittau)

diff --git a/gtk/gtkfilechooser.c b/gtk/gtkfilechooser.c
index 83c95f1f4386e14637b4efe92906b7cd56d8a385..6e8f54d32ebe49f00399ea1998f92a4a1cfd2954 100644 (file)
--- a/gtk/gtkfilechooser.c
+++ b/gtk/gtkfilechooser.c
@@ -1443,7 +1443,10 @@ gtk_file_chooser_get_extra_widget (GtkFileChooser *chooser)
  * 
  * Adds @filter to the list of filters that the user can select between.
  * When a filter is selected, only files that are passed by that
- * filter are displayed.
+ * filter are displayed. 
+ * 
+ * Note that the @chooser takes ownership of the filter, so you have to 
+ * ref and sink it if you want to keep a reference.
  *
  * Since: 2.4
  **/